Skip to content

Correct stale and removed wolfSSL macro names in the manual - #298

Merged
philljj merged 1 commit into
wolfSSL:masterfrom
dgarske:mp_invmod_ct_doc
Nov 13, 2026
Merged

philljj merged 1 commit into
wolfSSL:masterfrom
dgarske:mp_invmod_ct_doc

Conversation

@dgarske

@dgarske dgarske commented Nov 13, 2026

Copy link
Copy Markdown
Member

Checks the wolfSSL manual against the macros wolfSSL master actually uses.

  • WOLFSSL_MP_INVMOD_CONSTANT_TIME: Keep secret values out of the variable-time inversion in ECC, ECCSI, SAKKE and BN wolfssl#12023 removed it, so its entry now says it was removed after 5.9.4 and has no effect.
  • WOLFSSL_LEAVE_VERBOSE() is dropped from the verbose logging description (chapters 2 and 8); only WOLFSSL_MSG_VERBOSE() and WOLFSSL_ENTER_VERBOSE() exist.
  • Japanese manual, brought in line with the English text and the source:
    • Wrong names corrected: WOLFSSL_APPLE_NATIVE_CERT_VALIDATION, DH_CHECK_PRIV_E, HAVE_CAVIUM_OCTEON_SYNC, WOLFSSL_ATECC508A / WOLFSSL_ATECC608A, WOLFSSL_STM32MP13, and the SP size defines (WOLFSSL_SP_NO_2048 / _NO_3072 / _NO_256).
    • --enable-psk removes NO_PSK rather than defining HAVE_PSK, and the ECC example passes a key size of 32 instead of an undefined constant.
    • HAVE_LIBOQS is marked removed in 5.9.4, and the entries for WOLFSSL_USE_POPEN_HOST, NO_WOLFSSL_SHA256 and --enable-staticecdh, which no longer exist, are removed.

@dgarske dgarske self-assigned this Nov 13, 2026
Copilot AI balanced review requested due to automatic review settings November 13, 2026 21:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues block this documentation-only update to the English and Japanese wolfSSL manuals.

No open issues 🎉

What changed in this PR

This documentation-only PR aligns the English and Japanese wolfSSL manuals with current macro names and removes guidance for obsolete options.

Changes:

  • Marks removed macros as ineffective and corrects verbose logging macro lists.
  • Fixes Japanese macro names, hardware configuration references, and an ECC example.
  • Corrects PSK configuration guidance and removes obsolete entries.
File Description
wolfSSL/​src/​chapter08.md Removes the nonexistent verbose logging helper from the description.
wolfSSL/​src/​chapter02.md Documents the removed inverse macro and corrects verbose logging guidance.
wolfSSL/​src-ja/​chapter02.md Corrects macro documentation, removes obsolete entries, and fixes the ECC example.
wolfSSL/​src-ja/​appendix08.md Corrects SP size defines and hardware accelerator configuration references.
wolfSSL/​src-ja/​appendix07.md Corrects PSK configuration guidance and removes the obsolete static ECDH option.
wolfSSL/​src-ja/​appendix06.md Corrects the DH private-key error constant name.

Review effort: Balanced

@dgarske dgarske assigned wolfSSL-Bot and unassigned dgarske Nov 13, 2026
@dgarske
dgarske requested a review from philljj November 13, 2026 22:06
@philljj
philljj merged commit f1aff63 into wolfSSL:master Nov 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants